home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / raytrace / rayslide / rayslide.lha / ray-slides / README < prev    next >
Encoding:
Text File  |  1992-09-14  |  5.7 KB  |  135 lines
  1.           Rayshade and Utah Raster Toolkit slides
  2. ==============================================================================
  3.  
  4.                 Mark Maimone
  5.         Carnegie Mellon School of Computer Science
  6.                 mwm@cmu.edu
  7.  
  8.                 3 June 1992
  9.  
  10. ==============================================================================
  11.  
  12. This is a collection of 33+ slides I generated to introduce Rayshade (and
  13. the Utah Raster Toolkit) to my deparment.  They won't be right for
  14. everybody, because I didn't attempt to cover things in great detail; I just
  15. wanted to whet some appetites.  Also, several of the slides are very
  16. site-specific (enhancements I added, physical location of the code on our
  17. filesystem, etc).  So feel free to pick and choose, and make changes to
  18. anything.  I've provided the text of the slides in LaTeX, and the .ray files
  19. used to generate the rendered images.  If you do quote from them
  20. extensively, please mention where they came from, that's all I ask.
  21.  
  22. I used both color and greyscale outputs; color for the actual slides,
  23. greyscale (in the original) for the photocopies.  On my unix system, I
  24. stored all the greyscale in a "bw" subdirectory, color in a "color"
  25. subdirectory, and then did a "ln -s color ps" or "ln -s bw ps" to create a
  26. symbolic link to the appropriate directory.  Your mileage may vary, you
  27. might have to play with the makefile if this doesn't work for you.  Of all
  28. the source files, only two differ between the color and greyscale versions:
  29. pacbw.ray uses different backgrounds than pac.ray, and camera.bw is an idraw
  30. drawing with solid lines rather than colored.  These exceptions are taken
  31. care of by the Makefile's in the bw and color directories.
  32.  
  33. ==============================================================================
  34.                   HOW TO MAKE SLIDES
  35.  
  36.     First make sure you've got all the image-generating software:
  37.  
  38.         Rayshade 4.0.0 or later
  39.         Utah Raster Toolkit 3.0
  40.         LaTeX
  41.         enscript    [if you don't have this, plug in the name of
  42.                  any text->PostScript converter.  Hopefully
  43.                  it will generate bold, 15point text]
  44.         [optional] GNUplot 3.0
  45.  
  46.     Now you *SHOULDN'T NEED TO DO THIS STEP*, unless you've made changes
  47. to the .ray files or something.  Be aware that this step will invoke GNUplot
  48. to generate depth.ps.
  49.  
  50.         % cd slides/ray    [DON'T DO THIS!!!]
  51.         % make        [DON'T DO THIS!!!]
  52.  
  53.     Decide whether you want black and white images or color.  For color
  54. slides, do this:
  55.  
  56.     COLOR    % cd slides
  57.     COLOR    % ln -s color ps
  58.     COLOR    % cd color        [or cd ps, doesn't matter]
  59.     COLOR    % make
  60.  
  61. For black and white, do this instead:
  62.  
  63.     B&W    % cd slides
  64.     B&W    % ln -s bw ps
  65.     B&W    % cd bw            [or cd ps, doesn't matter]
  66.     B&W    % make
  67.  
  68. This will convert the existing .rle files (and others) into PostScript
  69. format.  Now, if you don't have the "enscript" program, change the file
  70. slides/Makefile to use a different text-to-PostScript formatter.  Finally,
  71. generate the LaTeX output:
  72.  
  73.         % cd slides
  74.         % make
  75.  
  76. (ignoring the many warnings about overfull hboxs and such) to give you
  77. following files:
  78.  
  79.     ray.ps:        pages 1-17 of the slides
  80.     page18.ps:    page 18
  81.     page19.ps:    page 19
  82.     page20.ps:    page 20
  83.     urt.ps:        pages 21-33 of the slides
  84.  
  85. You may want to print ray.ps in a fwe different pieces, it'll be 1.7meg in
  86. black and white and nearly 4meg in color.
  87.  
  88. ==============================================================================
  89. EXTENSIONS:  The only extensions I mention in these slides are depth map
  90. generation, and conversion between our local Generalized Image Format (GIL)
  91. and URT format.  The depth map has been incorporated into David Debry's
  92. 4.0.6enh version of rayshade.  Unfortunately, the URT slides are highly
  93. biased toward comparing the URT with our GIL, so they may not be useful
  94. outside of CMU.  But then again, if you want to contrast the URT with
  95. *your* local image format, you might get some ideas from them.  [send me
  96. mail if you want the gil2rle.c and rle2gil.c programs themselves]
  97.  
  98. CHEATING:  OK, I cheated somewhat in making these slides.  That is, several
  99. of the renderings aren't *exactly* generated by the sample code.  Here are the
  100. exeptions that I remember:
  101.  
  102.     -- sphere.ray -- (slide 4) -- The sphere has color (although none is
  103.        given in the example text)
  104.     -- ap1.ray, ap2.ray, mancyl.ray, diff.ray -- (slide 5) -- The
  105.        rendered images have a soft-colored background plane (because
  106.        rayshade has a black background by default, which looks terrible
  107.        on an overhead, as you can see from slide 4); the text on the
  108.        slide doesn't mention the background.
  109.     -- depth.plot -- (slides 8,9) -- As is explained in the Z buffer
  110.        (depth map) extension code, I didn't use the output of "rayshade
  111.        -z" directly; rather, it's been filtered through an awk script.
  112.        So the data file "ray/depth.plot" is not *exactly* the output of
  113.        "rayshade -z", but it's pretty darn close.  See the code in
  114.        4.0.6enh for a more complete explanation.
  115.  
  116. ADDITIONAL SLIDES:  When giving a talk, make as many extra slides of
  117. rendered images as you can.  People want to see pretty pictures, not words!
  118. In particular, I suggest making blown-up versions of pac.rle and
  119. depthcolor.rle (the first because it's cute, the second because it's hard to
  120. grasp).  There's nothing in the makefile for this, just use:
  121.  
  122.         rletops -h 6 -C pac.rle > pac.ps
  123.  
  124. or something similar.  I'm not going to explain rletops, read the man page.
  125. They also want to know how long it takes to generate the pictures, so keep
  126. that in mind too.
  127.  
  128. REBUILDING THE SLIDES:  It can take a while to generate the slides
  129. initially, because you may have to run rayshade nearly a dozen times to get
  130. the RLE images.  So try not to delete them prematurely!
  131.  
  132. COMMENTS:  Send your comments to me, Mark Maimone, mwm@cmu.edu.
  133. Unfortunately I'm in thesis mode, so I can't offer to make lots of changes.
  134. But I'll try to help get you started if I can.
  135.